๐๏ธGitะฏัะฐ๐๏ธ
docs/el-rGR/user/connections.md 0a44b948ec0573dc62ec68c19e46e62d40fcd1a3 (0a44b948) Text, 4.36 KB
title: Connections
parent: User Guide
nav_order: 2
last_updated: 2026-05-20
description: Connect your phone or desktop to a Meshtastic radio via Bluetooth, USB, or TCP/IP.
aliases:
โข bluetooth
โข usb
โข tcp
โข pairing
Connections
Meshtastic supports multiple transport methods to communicate between your phone/desktop and a radio node.
Bluetooth (BLE)
Bluetooth Low Energy is the default and most common connection method on Android.
Pairing a Device
1. Ensure your Meshtastic radio is powered on and in pairing mode.
2. Open the app and navigate to the Connect tab.
3. Tap Scan for Devices โ nearby Meshtastic radios will appear.
4. Select your device from the list.
5. Accept the Bluetooth pairing prompt if shown.
You can filter devices by transport type using the filter chips at the top:
โ ๐ก Tip: If your device doesn't appear, check that Bluetooth and Location permissions are granted,
โ and that the radio is not already connected to another device.
Connection Status
โโโโโโโโฌโโโโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ Icon โ State โ ฮ ฮตฯฮนฮณฯฮฑฯฮฎ โ
โโโโโโโโผโโโโโโโโโโโโโโโโโผโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโค
โ ๐ข โ Connected โ Active radio link established โ
โ ๐ก โ Connecting โ Handshake in progress โ
โ ๐ด โ ฮฯฮฟฯฯ
ฮฝฮดฮตฮดฮตฮผฮญฮฝฮฟ โ No active connection โ
โ โช โ Not configured โ No device selected โ
โโโโโโโโดโโโโโโโโโโโโโโโโโดโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
When connecting, a status indicator shows the current connection state:
If no devices are found, the app shows an empty state with instructions:
Troubleshooting Bluetooth
โข Device not found: Toggle Bluetooth off/on, ensure location is enabled.
โข Connection drops: Move closer to the radio; check for interference.
โข Pairing rejected: Forget the device in Android Bluetooth settings and retry.
USB Serial
USB connections provide a wired alternative, useful for desktop or when Bluetooth is unavailable.
Setup
1. Connect your radio via USB cable to your device.
2. The app will prompt for USB permission โ tap Allow.
3. The connection is established automatically.
โ โ ๏ธ Note: USB connections require OTG support on Android devices.
TCP/IP (WiFi)
Some Meshtastic radios support WiFi connectivity, allowing TCP-based connections.
Configuration
1. Connect your radio to a WiFi network via the radio's web interface or settings.
2. In the app, go to Connect โ TCP.
3. Enter the radio's IP address and port (default: 4403).
4. Tap Connect.
When a device is found, it appears in the connection list:
A successful connection is confirmed with a status indicator:
When to Use TCP
โข Radio is on the same local network
โข Testing with a simulated radio
โข Environments where Bluetooth has interference issues
Reconnection Behavior
The app reconnects to the last selected device on startup. You can switch transports from the Connect screen at any time.
To disconnect, tap the disconnect button on the Connect screen:
Desktop Connections
On Desktop (Linux/macOS/Windows), the app supports:
โข Bluetooth (BLE) โ via the Kable library; works on macOS, Linux, and Windows
โข USB Serial โ primary wired connection method
โข TCP/IP โ for network-connected radios
See Desktop App for platform-specific details and keyboard shortcuts.
Related Topics
โข Getting Started โ first-launch setup and permissions
โข Settings โ Radio & User โ Bluetooth and network configuration
โข Desktop App โ desktop-specific connection details
โข Supported devices โ full list of compatible radios on meshtastic.org
Served by rngit 1.5.4 - Generated in 0.04s